Attribute VB_Name = "fmod_dsp"
' ============================================================================================= '
' FMOD Ex - DSP Visual Basic Module. Copyright (c), Firelight Technologies Pty, Ltd. 2004-2008. '
'                                                                                               '
' Use this module if you are interested in delving deeper into the FMOD software mixing /       '
' DSP engine.  In this module you can find parameter structures for FMOD system reigstered      '
' DSP effects and generators.                                                                   '
'                                                                                               '
' ============================================================================================= '

'
'[Structure]
'[
    '[Description]
    'Structure that is passed into each callback.

    '[REMARKS]
    'Members marked with '[in] mean the user sets the value before passing it to the function.
    'Members marked with '[out] mean FMOD sets the value to be used after the function exits.

    '[PLATFORMS]
    'Win32, Win64, WinCE, Linux, Macintosh, XBox, PlayStation 2, GameCube

    '[SEE_ALSO]
    'FMOD_DSP_DESCRIPTION
']
'
Public Type FMOD_DSP
    userdata As Long    ' '[in]'[out] User created data the dsp plugin writer wants to attach to this object. '
End Type


'
    'DSP callbacks
'
'typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_CREATECALLBACK)  (FMOD_DSP *dsp);
'typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_RELEASECALLBACK) (FMOD_DSP *dsp);
'typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_RESETCALLBACK)   (FMOD_DSP *dsp);
'typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_READCALLBACK)    (FMOD_DSP *dsp, float *inbuffer, float *outbuffer, unsigned int length, int inchannels, int outchannels);
'typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_SETPOSITIONCALLBACK)    (FMOD_DSP *dsp, unsigned int seeklen);
'typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_SETPARAMCALLBACK)(FMOD_DSP *dsp, int index, float value);
'typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_GETPARAMCALLBACK)(FMOD_DSP *dsp, int index, float *value, char *valuestr);
'typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_DIALOGCALLBACK)  (FMOD_DSP *dsp, void *hwnd, int show);

'
'[ENUM]
'[
    '[Description]
    'These definitions can be used for creating FMOD defined special effects or DSP units.

    '[REMARKS]
    'To get them to be active, first create the unit, then add it somewhere into the DSP network, either at the front of the network near the soundcard unit to affect the global output (by using FMOD_System_GetDSPHead), or on a single channel (using FMOD_Channel_GetDSPHead).

    '[PLATFORMS]
    'Win32, Win64, WinCE, Linux, Macintosh, XBox, PlayStation 2, GameCube

    '[SEE_ALSO]
    'FMOD_System_CreateDSPByType
']
'
Public Enum FMOD_DSP_TYPE
    FMOD_DSP_TYPE_UNKNOWN            ' This unit was created via a non FMOD plugin so has an unknown purpose. '
    FMOD_DSP_TYPE_MIXER              ' This unit does nothing but take inputs and mix them together then feed the result to the soundcard unit. '
    FMOD_DSP_TYPE_OSCILLATOR         ' This unit generates sine/square/saw/triangle or noise tones. '
    FMOD_DSP_TYPE_LOWPASS            ' This unit filters sound using a high quality, resonant lowpass filter algorithm but consumes more CPU time. '
    FMOD_DSP_TYPE_ITLOWPASS          ' This unit filters sound using a resonant lowpass filter algorithm that is used in Impulse Tracker, but with limited cutoff range (0 to 8060hz). '
    FMOD_DSP_TYPE_HIGHPASS           ' This unit filters sound using a resonant highpass filter algorithm. '
    FMOD_DSP_TYPE_ECHO               ' This unit produces an echo on the sound and fades out at the desired rate. '
    FMOD_DSP_TYPE_FLANGE             ' This unit produces a flange effect on the sound. '
    FMOD_DSP_TYPE_DISTORTION         ' This unit distorts the sound. '
    FMOD_DSP_TYPE_NORMALIZE          ' This unit normalizes or amplifies the sound to a certain level. '
    FMOD_DSP_TYPE_PARAMEQ            ' This unit attenuates or amplifies a selected frequency range. '
    FMOD_DSP_TYPE_PITCHSHIFT         ' This unit bends the pitch of a sound without changing the speed of playback. '
    FMOD_DSP_TYPE_CHORUS             ' This unit produces a chorus effect on the sound. '
    FMOD_DSP_TYPE_REVERB             ' This unit produces a reverb effect on the sound. '
    FMOD_DSP_TYPE_VSTPLUGIN          ' This unit allows the use of Steinberg VST plugins '
    FMOD_DSP_TYPE_WINAMPPLUGIN       ' This unit allows the use of Nullsoft Winamp plugins '
    FMOD_DSP_TYPE_ITECHO             ' This unit produces an echo on the sound and fades out at the desired rate as is used in Impulse Tracker. '
    FMOD_DSP_TYPE_COMPRESSOR         ' This unit implements dynamic compression (linked multichannel, wideband) '
    FMOD_DSP_TYPE_SFXREVERB          ' This unit implements SFX reverb '
    FMOD_DSP_TYPE_LOWPASS_SIMPLE     ' This unit filters sound using a simple lowpass with no resonance, but has flexible cutoff and is fast. '
End Enum


'
'[STRUCTURE]
'[
    '[description]

    '[REMARKS]
    'Members marked with [in] mean the user sets the value before passing it to the function.
    'Members marked with [out] mean FMOD sets the value to be used after the function exits.
    '
    'The step parameter tells the gui or application that the parameter has a certain granularity.
    'For example in the example of cutoff frequency with a range from 100.0 to 22050.0 you might only want the selection to be in 10hz increments.  For this you would simply use 10.0 as the step value.
    'For a boolean, you can use min = 0.0, max = 1.0, step = 1.0.  This way the only possible values are 0.0 and 1.0.
    'Some applications may detect min = 0.0, max = 1.0, step = 1.0 and replace a graphical slider bar with a checkbox instead.
    'A step value of 1.0 would simulate integer values only.
    'A step value of 0.0 would mean the full floating point range is accessable.

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_System_CreateDSP
    'FMOD_DSP_SetParameter
']
'
Public Type FMOD_DSP_PARAMETERDESC
    min As Single                                ' [in] Minimum value of the parameter (ie 100.0). '
    max As Single                                ' [in] Maximum value of the parameter (ie 22050.0). '
    defaultval As Single                         ' [in] Default value of parameter. '
    name As String                               ' [in] Name of the parameter to be displayed (ie "Cutoff frequency"). '
    label As String                              ' [in] Short string to be put next to value to denote the unit type (ie "hz"). '
    description As String                        ' [in] Description of the parameter to be displayed as a help item / tooltip for this parameter. '
End Type


'
'[Structure]
'[
    '[Description]
    'Strcture to define the parameters for a DSP unit.

    '[REMARKS]
    'Members marked with '[in] mean the user sets the value before passing it to the function.
    'Members marked with '[out] mean FMOD sets the value to be used after the function exits.
    '
    'There are 2 different ways to change a parameter in this architecture.
    'One is to use FMOD_DSP_SetParameter / FMOD_DSP_GetParameter.  This is platform independant and is dynamic, so new unknown plugins can have their parameters enumerated and used.
    'The other is to use FMOD_DSP_ShowConfigDialog.  This is platform specific and requires a GUI, and will display a dialog box to configure the plugin.

    '[PLATFORMS]
    'Win32, Win64, WinCE, Linux, Macintosh, XBox, PlayStation 2, GameCube

    '[SEE_ALSO]
    'FMOD_DSP_CATEGORY
    'FMOD_System_CreateDSP
    'FMOD_System_GetDSP
']
'
'Public Type FMOD_DSP_DESCRIPTION
'    name As String                  ' [in] Name of the unit to be displayed in the network. '
'    version As Long                 ' [in] Plugin writer's version number. '
'    channels As Long                ' [in] Number of channels.  Use 0 to process whatever number of channels is currently in the network.  >0 would be mostly used if the unit is a fixed format generator and not a filter. '
'    create As Long                  ' [in] Create callback.  This is called when DSP unit is created.  Can be null. '
'    release As Long                 ' [in] Release callback.  This is called just before the unit is freed so the user can do any cleanup needed for the unit.  Can be null. '
'    reset As Long                   ' [in] Reset callback.  This is called by the user to reset any history buffers that may need resetting for a filter, when it is to be used or re-used for the first time to its initial clean state.  Use to avoid clicks or artifacts. '
'    read As Long                    ' [in] Read callback.  Processing is done here.  Can be null. '
'    setposition As Long             ' [in] Set position callback.  This is called if the unit becomes virtualized and needs to simply update positions etc.  Can be null. '
    
'    numparameters As Long           ' [in] Number of parameters used in this filter.  The user finds this with FMOD_DSP_GetNumParameters '
'    paramdesc As Long               ' [in] Variable number of parameter structures. '
'    setparameter As Long            ' [in] This is called when the user calls FMOD_DSP_SetParameter.  Can be null. '
'    getparameter As Long            ' [in] This is called when the user calls FMOD_DSP_GetParameter.  Can be null. '
'    config As Long                  ' [in] This is called when the user calls FMOD_DSP_ShowConfigDialog.  Can be used to display a dialog to configure the filter.  Can be null. '
'    configwidth As Long             ' [in] Width of config dialog graphic if there is one.  0 otherwise. '
'    configheight As Long            ' [in] Height of config dialog graphic if there is one.  0 otherwise. '
'    userdata as Long                ' [in] Optional. Specify 0 to ignore. This is user data to be attached to the DSP unit during creation.  Access via FMOD_DSP_GetUserData.'
'End Type


'
'    ===================================================================================================
'
'    FMOD built in effect parameters.
'    Use FMOD_DSP_SetParameter with these enums for the 'index' parameter.
'
'    ===================================================================================================
'

'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_OSCILLATOR filter.

    '[REMARKS]

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_OSCILLATOR
    FMOD_DSP_OSCILLATOR_TYPE    ' Waveform type.  0 = sine.  1 = square. 2 = sawup. 3 = sawdown. 4 = triangle. 5 = noise.  '
    FMOD_DSP_OSCILLATOR_RATE    ' Frequency of the sinewave in hz.  1.0 to 22000.0.  Default = 220.0. '
End Enum


'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_LOWPASS filter.

    '[REMARKS]

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_LOWPASS
    FMOD_DSP_LOWPASS_CUTOFF     ' Lowpass cutoff frequency in hz.   1.0 to 22000.0.  Default = 5000.0. '
    FMOD_DSP_LOWPASS_RESONANCE  ' Lowpass resonance Q value. 1.0 to 10.0.  Default = 1.0. '
End Enum


'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_LOWPASS2 filter.

    '[REMARKS]

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_ITLOWPASS
    FMOD_DSP_ITLOWPASS_CUTOFF     ' Lowpass cutoff frequency in hz.  1.0 to 22000.0.  Default = 5000.0/ '
    FMOD_DSP_ITLOWPASS_RESONANCE  ' Lowpass resonance Q value.  0.0 to 127.0.  Default = 1.0. '
End Enum


'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_HIGHPASS filter.

    '[REMARKS]

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_HIGHPASS
    FMOD_DSP_HIGHPASS_CUTOFF     ' Highpass cutoff frequency in hz.  10.0 to output 22000.0.  Default = 5000.0. '
    FMOD_DSP_HIGHPASS_RESONANCE  ' Highpass resonance Q value.  1.0 to 10.0.  Default = 1.0. '
End Enum


'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_ECHO filter.

    '[REMARKS]
    'Note.  Every time the delay is changed, the plugin re-allocates the echo buffer.  This means the echo will dissapear at that time while it refills its new buffer.
    'Larger echo delays result in larger amounts of memory allocated.
    '
    '<i>maxchannels</i>' also dictates the amount of memory allocated.  By default, the maxchannels value is 0.  If FMOD is set to stereo, the echo unit will allocate enough memory for 2 channels.  If it is 5.1, it will allocate enough memory for a 6 channel echo, etc.
    'If the echo effect is only ever applied to the global mix (ie it was added with FMOD_System_AddDSP), then 0 is the value to set as it will be enough to handle all speaker modes.
    'When the echo is added to a channel (ie FMOD_Channel_AddDSP) then the channel count that comes in could be anything from 1 to 8 possibly.  It is only in this case where you might want to increase the channel count above the output's channel count.
    'If a channel echo is set to a lower number than the sound's channel count that is coming in, it will not echo the sound.

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_ECHO
    FMOD_DSP_ECHO_DELAY        ' Echo delay in ms.  10  to 5000.  Default = 500. '
    FMOD_DSP_ECHO_DECAYRATIO   ' Echo decay per delay.  0 to 1.  1.0 = No decay, 0.0 = total decay.  Default = 0.5. '
    FMOD_DSP_ECHO_MAXCHANNELS  ' Maximum channels supported.  0 to 16.  0 = same as fmod's default output polyphony, 1 = mono, 2 = stereo etc.  See remarks for more.  Default = 0.  It is suggested to leave at 0! '
    FMOD_DSP_ECHO_DRYMIX       ' Volume of original signal to pass to output.  0.0 to 1.0. Default = 1.0. '
    FMOD_DSP_ECHO_WETMIX       ' Volume of echo signal to pass to output.  0.0 to 1.0. Default = 1.0. '
End Enum


'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_FLANGE filter.

    '[REMARKS]
    'Flange is an effect where the signal is played twice at the same time, and one copy slides back and forth creating a whooshing or flanging effect.
    'As there are 2 copies of the same signal, by default each signal is given 50% mix, so that the total is not louder than the original unaffected signal.
    '
    'Flange depth is a percentage of a 10ms shift from the original signal.  Anything above 10ms is not considered flange because to the ear it begins to 'echo' so 10ms is the highest value possible.

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_FLANGE
    FMOD_DSP_FLANGE_DRYMIX      ' Volume of original signal to pass to output.  0.0 to 1.0. Default = 0.45. '
    FMOD_DSP_FLANGE_WETMIX      ' Volume of flange signal to pass to output.  0.0 to 1.0. Default = 0.55. '
    FMOD_DSP_FLANGE_DEPTH       ' Flange depth.  0.01 to 1.0.  Default = 1.0. '
    FMOD_DSP_FLANGE_RATE        ' Flange speed in hz.  0.0 to 20.0.  Default = 0.1. '
End Enum


'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_DISTORTION filter.

    '[REMARKS]

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_DISTORTION
    FMOD_DSP_DISTORTION_LEVEL    ' Distortion value.  0.0 to 1.0.  Default = 0.5. '
End Enum


'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_NORMALIZE filter.

    '[REMARKS]
    'Normalize amplifies the sound based on the maximum peaks within the signal.
    'For example if the maximum peaks in the signal were 50% of the bandwidth, it would scale the whole sound by 2.
    'The lower threshold value makes the normalizer ignores peaks below a certain point, to avoid over-amplification if a loud signal suddenly came in, and also to avoid amplifying to maximum things like background hiss.
    '
    'Because FMOD is a realtime audio processor, it doesn't have the luxury of knowing the peak for the whole sound (ie it can't see into the future), so it has to process data as it comes in.
    'To avoid very sudden changes in volume level based on small samples of new data, fmod fades towards the desired amplification which makes for smooth gain control.  The fadetime parameter can control this.

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_NORMALIZE
    FMOD_DSP_NORMALIZE_FADETIME     ' Time to ramp the silence to full in ms.  0.0 to 20000.0. Default = 5000.0. '
    FMOD_DSP_NORMALIZE_THRESHHOLD   ' Lower volume range threshold to ignore.  0.0 to 1.0.  Default = 0.1.  Raise higher to stop amplification of very quiet signals. '
    FMOD_DSP_NORMALIZE_MAXAMP       ' Maximum amplification allowed.  1.0 to 100000.0.  Default = 20.0.  1.0 = no amplifaction, higher values allow more boost. '
End Enum


'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_PARAMEQ filter.

    '[REMARKS]
    'Parametric EQ is a bandpass filter that attenuates or amplifies a selected frequency and its neighbouring frequencies.
    '
    'To create a multi-band EQ create multiple FMOD_DSP_TYPE_PARAMEQ units and set each unit to different frequencies, for example 1000hz, 2000hz, 4000hz, 8000hz, 16000hz with a range of 1 octave each.
    '
    'When a frequency has its gain set to 1.0, the sound will be unaffected and represents the original signal exactly.

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_PARAMEQ
    FMOD_DSP_PARAMEQ_CENTER      ' Frequency center.  20.0 to 22000.0.  Default = 8000.0. '
    FMOD_DSP_PARAMEQ_BANDWIDTH   ' Octave range around the center frequency to filter.  0.2 to 5.0.  Default = 1.0. '
    FMOD_DSP_PARAMEQ_GAIN        ' Frequency Gain.  0.05 to 3.0.  Default = 1.0.  '
End Enum


'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_PITCHSHIFT filter.

    '[REMARKS]
    'This pitch shifting unit can be used to change the pitch of a sound without speeding it up or slowing it down.
    'It can also be used for time stretching or scaling, for example if the pitch was doubled, and the frequency of the sound was halved, the pitch of the sound would sound correct but it would be twice as slow.
    '
    '<b>Warning!</b> This filter is very computationally expensive!  Similar to a vocoder, it requires several overlapping FFT and IFFT's to produce smooth output, and can require around 440mhz for 1 stereo 48khz signal using the default settings.
    'Reducing the signal to mono will half the cpu usage, as will the overlap count.
    'Reducing this will lower audio quality, but what settings to use are largely dependant on the sound being played.  A noisy polyphonic signal will need higher overlap and fft size compared to a speaking voice for example.
    '
    'This pitch shifter is based on the pitch shifter code at http://www.dspdimension.com, written by Stephan M. Bernsee.
    'The original code is COPYRIGHT 1999-2003 Stephan M. Bernsee <smb@dspdimension.com>.
    '
    '<i>maxchannels</i>' dictates the amount of memory allocated.  By default, the maxchannels value is 0.  If FMOD is set to stereo, the pitch shift unit will allocate enough memory for 2 channels.  If it is 5.1, it will allocate enough memory for a 6 channel pitch shift, etc.
    'If the pitch shift effect is only ever applied to the global mix (ie it was added with FMOD_System_AddDSP), then 0 is the value to set as it will be enough to handle all speaker modes.
    'When the pitch shift is added to a channel (ie FMOD_Channel_AddDSP) then the channel count that comes in could be anything from 1 to 8 possibly.  It is only in this case where you might want to increase the channel count above the output's channel count.
    'If a channel pitch shift is set to a lower number than the sound's channel count that is coming in, it will not pitch shift the sound.

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_PITCHSHIFT
    FMOD_DSP_PITCHSHIFT_PITCH        ' Pitch value.  0.5 to 2.0.  Default = 1.0. 0.5 = one octave down, 2.0 = one octave up.  1.0 does not change the pitch. '
    FMOD_DSP_PITCHSHIFT_FFTSIZE      ' FFT window size.  256, 512, 1024, 2048, 4096.  Default = 1024.  Increase this to reduce 'smearing'.  This effect is a warbling sound similar to when an mp3 is encoded at very low bitrates. '
    FMOD_DSP_PITCHSHIFT_OVERLAP      ' Window overlap.  1 to 32.  Default = 4.  Increase this to reduce 'tremolo' effect.  Increasing it by a factor of 2 doubles the CPU usage. '
    FMOD_DSP_PITCHSHIFT_MAXCHANNELS  ' Maximum channels supported.  0 to 16.  0 = same as fmod's default output polyphony, 1 = mono, 2 = stereo etc.  See remarks for more.  Default = 0.  It is suggested to leave at 0! '
End Enum


'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_CHORUS filter.

    '[REMARKS]
    'Chrous is an effect where the sound is more 'spacious' due to 1 to 3 versions of the sound being played along side the original signal but with the pitch of each copy modulating on a sine wave.
    'This is a highly configurable chorus unit.  It supports 3 taps, small and large delay times and also feedback.
    'This unit also could be used to do a simple echo, or a flange effect.

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_CHORUS
    FMOD_DSP_CHORUS_DRYMIX    ' Volume of original signal to pass to output.  0.0 to 1.0. Default = 0.5. '
    FMOD_DSP_CHORUS_WETMIX1   ' Volume of 1st chorus tap.  0.0 to 1.0.  Default = 0.5. '
    FMOD_DSP_CHORUS_WETMIX2   ' Volume of 2nd chorus tap. This tap is 90 degrees out of phase of the first tap.  0.0 to 1.0.  Default = 0.5. '
    FMOD_DSP_CHORUS_WETMIX3   ' Volume of 3rd chorus tap. This tap is 90 degrees out of phase of the second tap.  0.0 to 1.0.  Default = 0.5. '
    FMOD_DSP_CHORUS_DELAY     ' Chorus delay in ms.  0.1 to 100.0.  Default = 40.0 ms. '
    FMOD_DSP_CHORUS_RATE      ' Chorus modulation rate in hz.  0.0 to 20.0.  Default = 0.8 hz. '
    FMOD_DSP_CHORUS_DEPTH     ' Chorus modulation depth.  0.0 to 1.0.  Default = 0.03. '
    FMOD_DSP_CHORUS_FEEDBACK  ' Chorus feedback.  Controls how much of the wet signal gets fed back into the chorus buffer.  0.0 to 1.0.  Default = 0.0. '
End Enum


'
'[ENUM]
'[
    '[DESCRIPTION]
    'Parameter types for the FMOD_DSP_TYPE_REVERB filter.

    '[REMARKS]

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_REVERB
    FMOD_DSP_REVERB_ROOMSIZE  ' Roomsize. 0.0 to 1.0.  Default = 0.5 '
    FMOD_DSP_REVERB_DAMP      ' Damp.     0.0 to 1.0.  Default = 0.5 '
    FMOD_DSP_REVERB_WETMIX    ' Wet mix.  0.0 to 1.0.  Default = 0.33 '
    FMOD_DSP_REVERB_DRYMIX    ' Dry mix.  0.0 to 1.0.  Default = 0.0 '
    FMOD_DSP_REVERB_WIDTH     ' Width.    0.0 to 1.0.  Default = 1.0 '
    FMOD_DSP_REVERB_MODE      ' Mode.     0 (normal), 1 (freeze).  Default = 0 '
End Enum


'
'[ENUM]
'[
    '[DESCRIPTION]
    'Parameter types for the FMOD_DSP_TYPE_ITECHO filter.
    'This is effectively a software based echo filter that emulates the DirectX DMO echo effect.  Impulse tracker files can support this, and FMOD will produce the effect on ANY platform, not just those that support DirectX effects!

    '[REMARKS]
    'Note.  Every time the delay is changed, the plugin re-allocates the echo buffer.  This means the echo will dissapear at that time while it refills its new buffer.
    'Larger echo delays result in larger amounts of memory allocated.
    '
    'For stereo signals only!  This will not work on mono or multichannel signals.  This is fine for .IT format purposes, and also if you use FMOD_System_AddDSP with a standard stereo output.

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
    'FMOD_System_AddDSP
']
'
Public Enum FMOD_DSP_ITECHO
    FMOD_DSP_ITECHO_WETDRYMIX      ' Ratio of wet (processed) signal to dry (unprocessed) signal. Must be in the range from 0.0 through 100.0 (all wet). The default value is 50. '
    FMOD_DSP_ITECHO_FEEDBACK       ' Percentage of output fed back into input, in the range from 0.0 through 100.0. The default value is 50. '
    FMOD_DSP_ITECHO_LEFTDELAY      ' Delay for left channel, in milliseconds, in the range from 1.0 through 2000.0. The default value is 500 ms. '
    FMOD_DSP_ITECHO_RIGHTDELAY     ' Delay for right channel, in milliseconds, in the range from 1.0 through 2000.0. The default value is 500 ms. '
    FMOD_DSP_ITECHO_PANDELAY       ' Value that specifies whether to swap left and right delays with each successive echo. The default value is zero, meaning no swap. Possible values are defined as 0.0 (equivalent to FALSE) and 1.0 (equivalent to TRUE). '
End Enum


'
'[ENUM]
'[
    '[description]
    'Parameter types for the FMOD_DSP_TYPE_COMPRESSOR unit.
    'This is a simple linked multichannel software limiter that is uniform across the whole spectrum.

'[REMARKS]
    'The parameters are as follows:
    'Threshold:     [-60dB to 0dB, default 0dB]
    'Attack Time: [10ms to 200ms, default 50ms]
    'release Time: [20ms to 1000ms, default 50ms]
    'Gain Make Up: [0dB to +30dB, default 0dB]
    '
    'The limiter is not guaranteed to catch every peak above the threshold level,
    'because it cannot apply gain reduction instantaneously - the time delay is
    'determined by the attack time. However setting the attack time too short will
    'distort the sound, so it is a compromise. High level peaks can be avoided by
    'using a short attack time - but not too short, and setting the threshold a few
    'decibels below the critical level.
    '

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]
    'FMOD_DSP_Setparameter
    'FMOD_DSP_Getparameter
    'FMOD_DSP_TYPE
    'FMOD_System_addDSP
']
'
Public Enum FMOD_DSP_COMPRESSOR
    FMOD_DSP_COMPRESSOR_THRESHOLD   ' Threshold level (dB)in the range from -60 through 0. The default value is 50. '
    FMOD_DSP_COMPRESSOR_ATTACK      ' Gain reduction attack time (milliseconds), in the range from 10 through 200. The default value is 50. '
    FMOD_DSP_COMPRESSOR_RELEASE     ' Gain reduction release time (milliseconds), in the range from 20 through 1000. The default value is 50. '
    FMOD_DSP_COMPRESSOR_GAINMAKEUP  ' Make-up gain applied after limiting, in the range from 0.0 through 100.0. The default value is 50. '
End Enum


'
'[ENUM]
'[  
    '[DESCRIPTION]   
    'Parameter types for the FMOD_DSP_TYPE_SFXREVERB unit.
    
    '[REMARKS]
    'This is a high quality I3DL2 based reverb which improves greatly on FMOD_DSP_REVERB.
    'On top of the I3DL2 property set, "Dry Level" is also included to allow the dry mix to be changed.
    '
    'Currently FMOD_DSP_SFXREVERB_REFLECTIONSLEVEL, FMOD_DSP_SFXREVERB_REFLECTIONSDELAY and FMOD_DSP_SFXREVERB_REVERBDELAY are not enabled but will come in future versions.
    '
    'These properties can be set with presets in FMOD_REVERB_PRESETS.

    '[PLATFORMS]
    'Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii

    '[SEE_ALSO]      
    'FMOD_DSP_SetParameter
    'FMOD_DSP_GetParameter
    'FMOD_DSP_TYPE
    'FMOD_System_AddDSP
    'FMOD_REVERB_PRESETS
']
'*/
Public Enum FMOD_DSP_SFXREVERB
    FMOD_DSP_SFXREVERB_DRYLEVEL             ' Dry Level      : Mix level of dry signal in output in mB.  Ranges from -10000.0 to 0.0.  Default is 0.0. '
    FMOD_DSP_SFXREVERB_ROOM                 ' Room           : Room effect level at low frequencies in mB.  Ranges from -10000.0 to 0.0.  Default is 0.0. '
    FMOD_DSP_SFXREVERB_ROOMHF               ' Room HF        : Room effect high-frequency level re. low frequency level in mB.  Ranges from -10000.0 to 0.0.  Default is 0.0. '
    FMOD_DSP_SFXREVERB_ROOMROLLOFFFACTOR    ' Room Rolloff   : Like DS3D flRolloffFactor but for room effect.  Ranges from 0.0 to 10.0. Default is 10.0 '
    FMOD_DSP_SFXREVERB_DECAYTIME            ' Decay Time     : Reverberation decay time at low-frequencies in seconds.  Ranges from 0.1 to 20.0. Default is 1.0. '
    FMOD_DSP_SFXREVERB_DECAYHFRATIO         ' Decay HF Ratio : High-frequency to low-frequency decay time ratio.  Ranges from 0.1 to 2.0. Default is 0.5. '
    FMOD_DSP_SFXREVERB_REFLECTIONSLEVEL     ' Reflections    : Early reflections level relative to room effect in mB.  Ranges from -10000.0 to 1000.0.  Default is -10000.0. '
    FMOD_DSP_SFXREVERB_REFLECTIONSDELAY     ' Reflect Delay  : Delay time of first reflection in seconds.  Ranges from 0.0 to 0.3.  Default is 0.02. '
    FMOD_DSP_SFXREVERB_REVERBLEVEL          ' Reverb         : Late reverberation level relative to room effect in mB.  Ranges from -10000.0 to 2000.0.  Default is 0.0. '
    FMOD_DSP_SFXREVERB_REVERBDELAY          ' Reverb Delay   : Late reverberation delay time relative to first reflection in seconds.  Ranges from 0.0 to 0.1.  Default is 0.04. '
    FMOD_DSP_SFXREVERB_DIFFUSION            ' Diffusion      : Reverberation diffusion (echo density) in percent.  Ranges from 0.0 to 100.0.  Default is 100.0. '
    FMOD_DSP_SFXREVERB_DENSITY              ' Density        : Reverberation density (modal density) in percent.  Ranges from 0.0 to 100.0.  Default is 100.0. '
    FMOD_DSP_SFXREVERB_HFREFERENCE          ' HF Reference   : Reference high frequency in Hz.  Ranges from 20.0 to 20000.0. Default is 5000.0. '
End Enum


'
'[ENUM]
'[  
'    [DESCRIPTION]   
'    Parameter types for the FMOD_DSP_TYPE_LOWPASS_SIMPLE filter.
'    This is a very simple low pass filter, based on two single-pole RC time-constant modules.
'    The emphasis is on speed rather than accuracy, so this should not be used for task requiring critical filtering. 
'
'    [REMARKS]
'
'    [PLATFORMS]
'    Win32, Win64, Linux, Linux64, Macintosh, Xbox, Xbox360, PlayStation 2, GameCube, PlayStation Portable, PlayStation 3, Wii
'
'    [SEE_ALSO]      
'    FMOD_DSP_SetParameter
'    FMOD_DSP_GetParameter
'    FMOD_DSP_TYPE
']
'
Public Enum FMOD_DSP_LOWPASS_SIMPLE
    FMOD_DSP_LOWPASS_SIMPLE_CUTOFF     ' Lowpass cutoff frequency in hz.  10.0 to 22000.0.  Default = 5000.0 '
End Enum
